home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / PROGTOOL / SIMCODE.ZIP;1 / SIMCODE.DOC < prev    next >
Encoding:
Text File  |  1993-06-03  |  30.2 KB  |  712 lines

  1.  
  2.            -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  3.             SimCode Programming Language.
  4.            -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  5.  
  6.                [Version 6.5c]
  7.  
  8.          Copyright  (c) 1993 By Michael Whitt
  9.          All Rights Reserved By Michael Whitt
  10.  
  11.               Support BBS <The Intrepid> (502)856-3357
  12.  
  13.   I, Michael Whitt hereby claim no responsibity for any damage caused by SimCode,
  14.  nor do I make any claims to the portablity of SimCode on any systems other than
  15.  complete 100% IBM compatibles.  SimCode is released as Shareware, and I believe
  16.  that you will like using and that you will want to register it.  I am offering
  17.  the complete SimCode Package as freeware at this time.
  18.  
  19. ////////////////////////////////////////////////////////////////////////////////
  20.  
  21.  First off:  Program updates may be found on the following Bulletin Boards.
  22.  The Intrepid       - Maximus  - 1-502-856-3357 - 12-57.6kps    24hours a day.
  23.  The CD-Central     - Maximus  - 1-502-658-3647 - 1200-2400bps 10pm-7am CST.
  24.  The SteelHeart     - Renegarde- 1-502-898-4810 - 300-28.8kps  (2 lines)
  25.  The Listening Post - VBBS 5.1 - 1-502-554-3082 - 300-14,400bps 24hours a day.
  26.  The HUG Board      - RBBS     - 1-502-554-0614 - 300-9600bps   24hours a day.
  27.  The PCC Board      - Wildcat  - 1-502-554-4201 - 300-2400bps   24hours a day.
  28.  
  29.  
  30. To Contact Michael Whitt by Voice call (502)856-3788  or write to:
  31.  
  32.                     Michael Whitt
  33.                     Route 1 Box 81-d 
  34.                     Hickory, Ky. 42051
  35.  
  36. ---
  37.  
  38.   You may want to call one of the beta testers:
  39.  
  40.   Andy Perkins - (502)658-3647
  41.                or
  42.   Garrie Wilson - (502)247-9967
  43.  
  44.  Even if you dont wish to register SimCode, I would appreciate you just calling
  45.  or mailing me a postcard, Thanx a lot.
  46.  
  47. \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
  48.         
  49.          |||||||||||||||||||||||||||||||||||||||||
  50.          | Introduction to Simple Code (SimCode) |
  51.          |||||||||||||||||||||||||||||||||||||||||
  52.  
  53.   SimCode currently is a small easy to use programming language that is used
  54.   by many new computers as a first time programming experence.  Never before
  55.   has basic (as in simple, not as in the language) programming be so simple.
  56.  
  57.  
  58. --Additions from last versions....
  59.  
  60. Besides the addition of about ten more commands, and a new Con mode, undoubtably
  61. the most important change was a complete rewrite in the # and ^ commands.
  62.  
  63. With previous versions the # and ^ command where used to Write a line of text to
  64. the screen, as long as that line of text did not include more than 255 
  65. characters the # command would not only write the line to the screen but would
  66. also space down a line.  
  67.  
  68. The complete rewrite was done so that reqular text and ascii characters could be
  69. added to the entire screen.  To do this the # and ^ commands are no longer 
  70. limited to 255 characters, and they are only limited by your memory.  Also a 
  71. major change in these commands are that the # command is now exactly like the ^
  72. command.  If you wish to space down a line you must now just type a @ sign when
  73. ever you wish to space down a line.
  74.  
  75. Example: (with Version 2-4)
  76.  
  77. ~Red~
  78. #I am a SimCode Program# #Aint I nice?#
  79.  
  80. would display 
  81.  
  82. I am a SimCode Program
  83. Aint I nice?
  84.  
  85. Example (with Version 6.0)
  86.  
  87. ~Red~
  88. #I am a SimCode Program# @ #Aint I nice?#
  89.  
  90. would display
  91.  
  92. I am a SimCode Program 
  93. Aint I nice?
  94.  
  95. where-as the exact copy of the example from Version 2-4 would
  96. produce the following to the screen in Version 6.0:
  97.  
  98. I am a SimCode ProgramAint I nice?
  99.  
  100.  
  101. Now I think that you can see the diffrence.
  102.  
  103. The major reason for this changes was for the introduction of the Txt2Scs 
  104. Utility so that ANY text or ascii file can be used in Scripting.
  105.  
  106. ----------
  107.  
  108. Also a major update from Version 6.0 is the introduction of the File and 
  109. Printer commands ~OPEN ~, ~APPEND ~, and ~PRINT ~.
  110.  
  111. The Open command must be used before any Append command.  The Open command
  112. assigns a filename to write to, if the file already exist it just appends or
  113. adds on to it, else it creates the file. Example Use for Open given the file
  114. Names.Txt:
  115.          ~Open Names.Txt~
  116.  
  117. The Append command is the actually file writing command in SimCode, all info
  118. that it stores to a file is in ASCII Text, and can be read a numerous amount
  119. of ways, including coverting it into a SCS file with Txt2Scs. You MUST declare
  120. a file to open and append to using the Open command before the Append Command
  121. will work. Example Use for Append:
  122.  
  123. Example 1: Writing a string to the file:
  124.                                         ~Append <Hello World.>~
  125.  
  126. Example 2: Writing a variable-letter to the file:
  127.                         ~Append A~
  128.  
  129. The Print Command is a added utility that will send either text or variables
  130. to the printer.
  131.  
  132. Example 1: Writing a string to the file:
  133.                                         ~Print <Bye Bye.>~
  134.  
  135. Example 2: Writing a Variable-letter to the file:
  136.                         ~Print A~
  137.  
  138. ---------
  139.  
  140. Another Addition Change is in the Run command, you can now specify Paremeters
  141. to be passed to a Runned Program.
  142.  
  143. Example 1: ~RUN PKZIP.EXE : MyZip~
  144.  
  145. Example 2: ~RUN WIN.COM : /3~
  146.  
  147. Anything after the : comamnd is considered a Parameter.  a null parameter pass
  148. would be: ~Run Pkzip.exe : ~
  149.  
  150. ---------
  151.  
  152. A new Script Calling System has been added also the Call command will call 
  153. other Script files:
  154.  
  155. Example 1: ~CALL MyScript.Scs 1~
  156.  
  157.       The above will call MyScript.Scs and initize the starting color to blue~
  158.  
  159. Example 2: ~Call script.SCS  ~ 
  160.         
  161.       This would call Script and nullify the color to the original Red setting.
  162.  
  163. ----------
  164.  
  165. The Con mode was also added into SimCode, see below for more details.
  166.  
  167. --------------------------End of Update---------------------------------------- 
  168.          
  169. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  170.  
  171. Okay lets get started on your tour of SimCode...
  172.  
  173.  
  174. ********************************************************************************
  175.  
  176.  
  177. First lets list the Shareware SimCode Commands and their Functions:
  178.  
  179. These are not in any perticular order.
  180.  
  181.  
  182. ~Run filename : parameters~  =- This Command will Run external programs. 
  183.                 Example: ~Run Agame.Exe : CGA MOUSE~
  184.                 The Above would load the program Agame.exe
  185.                 and pass CGA and Mouse to it as Parameters.
  186.                 This is useful for linking SimCode and other
  187.                 EXE, COM, BAT, and script files together.
  188.             
  189. ~Call Script colornumber~    =- To call other SimCode Command Scripts, you
  190.                 would Type ~CALL MyScript.SCS colornumber~
  191.                 After the linked Script is finished, the
  192.                 linked SimCode will fall back to the Parent
  193.                 SimCode.  Note: A total of 25 Calls has can 
  194.                 Be used with 512k or ram.
  195.                 *Note, if you wish to load multiple Scripts
  196.                 you may wish to use the following parameters:
  197.                 ~Call Myscript colornumber~ the parameter 
  198.                 colornumber connvert the number it to a 
  199.                 ASCIIcolor. This is helpful when you are 
  200.                  running Text Files that are Converted into SCS
  201.                 withthe TXT2SCS program.  You dont have to pass 
  202.                 a Colornumber parameter, but I would advise it. 
  203.                        Example: 
  204.                  ~Call MySCS.SCS 3~ would load MySCS
  205.                 with the default color of 3.
  206.                                  
  207.  
  208. ~Get letter-variable~        =- This Command will store a string to memory.
  209.                 Example: ~Get A~ will store any user input
  210.                 up to 80 characters long into a Varible known
  211.                 as A.  You have up to 26 variables to use in
  212.                 the Shareware Version of SimCode.  They are
  213.                 A through Z.  See ~Use letter-variable~ 
  214.  
  215. ~Use letter-variable~        =- This Command will retrieve a string from memory.
  216.                 Example: ~Use A~ will retrieve any user input
  217.                 that was stored with the ~Get A~ command. Please
  218.                 note that all variables are Null at first.  You
  219.                 have up to 26 variables to retrieve. A to Z.
  220.  
  221. ~TIME~                       =- This Command will print to the user screen the
  222.                 current time in the following format:
  223.                 The Current Time is 12:00:00. 
  224.  
  225. ~DATE~                       =- This Command will print to the user screen the
  226.                 current date in the following format:
  227.                 The Cureent Date is 1/1/80.
  228.  
  229. ~MORE~                       =- Will display --Please press a key-- to the user
  230.                 screen and wait for the user to press a key then
  231.                 the program will continue.
  232.  
  233. ~ENTER~                      =- Will display --Please press ENTER-- to the user
  234.                 screen and wait for the user to press the enter
  235.                 key for the program to continue.
  236.  
  237. ~HALT~                       =- Causes Script program to stop on a dime.  Please
  238.                 note that in the Shareware Version of SimCode 
  239.                 the only real use for the ~Halt~ command is in
  240.                 the SimCode < Con mode.  In the SimCode < Con
  241.                 mode the ~Halt~ command will exit SimCode, also
  242.                 the ^Z or Control-Z command also acts as the 
  243.                 ~Halt~ command in the SimCode < Con Mode.
  244.                 See SimCode < Con Mode.
  245.  
  246. ~DOS~                        =- This command dos what it says, it will create a
  247.                 Dos shell.  Type Exit to return to SimCode. Also
  248.                 ~DOS~ reminds the user to type Exit to leave the
  249.                 shell.
  250.  
  251. ~RED~                        =- Changes Text Foreground Color to Red.
  252.  
  253. ~BLUE~                       =- Changes Text Foreground Color to Blue.
  254.  
  255. ~GREEN~                      =- Changes Text Foreground Color to Green.
  256.  
  257. ~WHITE~                      =- Changes Text Foreground Color to White.
  258.  
  259. ~BLACK~                      =- Changes Text Foreground Color to Black.
  260.  
  261. ~CYAN~                       =- Changes Text Foreground Color to Cyan.
  262.  
  263. ~YELLOW~                     =- Changes Text Foreground Color to Yellow.  
  264.  
  265. ~CLEAR~                      =- Clears all screen attributes.  Equal to CLS.
  266.                 This command can also be used with the ~BACK ~
  267.                 command and ~Bcolor ~ Commands.
  268.  
  269. ~SOUNDmhz,length~            =- This Command will play the selected MegaHertz 
  270.                 for the set length of time in milli-seconds.
  271.                 Example: ~Sound400,1000~ will play 400mhz for
  272.                 a total of 1000 milli-seconds or 1 second.
  273.  
  274. ~STAR~                       =- This command is a little extra command that
  275.                 plays a familar tune, thats all, try it out.
  276.  
  277. ~YN~                         =- Waits for Y/N Input, currently not used in the
  278.                 Shareware version of SimCode.
  279.  
  280. ~ASCIInumber~                =- Displays Ascii character for the Ascii number
  281.                 chosen. Example: ~ASCII1~ would display the
  282.                 Ascii character which is a Smiley Face. Try it
  283.                 out to completly understand the command.
  284.  
  285. ~XYxlocation,ylocation~      =- Moves the Text XY location for the current place
  286.                 to the specified XY location. Example: ~XY40,24~
  287.                 would move the cursor from whatever the current
  288.                 location is to column 40 on line 24. Useful in
  289.                 the # # and ^ ^ commands, as well as others.
  290.  
  291. ~BACK RED~                   =- Changes Text Background Color to Red.
  292.  
  293. ~BACK GREEN~                 =- Changes Text Background Color to Green.
  294.  
  295. ~BACK BLUE~                  =- Changes Text Background Color to Blue.
  296.  
  297. ~BACK YELLOW~                =- Changes Text Background Color to Yellow.
  298.  
  299. ~BACK BLACK~                 =- Changes Text Background Color to Black.
  300.  
  301. ~BACK WHITE~                 =- Changes Text Background Color to White.
  302.  
  303. ~BACK CYAN~                  =- Changes Text Background Color to Cyan.
  304.  
  305. *note on ~BACK ~ commands. If you wish to initalize the entire screen background
  306. to the ~BACK ~ color then you should use the ~CLEAR~ command after it, else only
  307. the screen attributes behind the current cursor location. Try it out and see.*
  308.  
  309. ~COLORnumber~                =- Changes Text Foreground Color to the selected
  310.                 number that fits its ASCII Color Number. 
  311.                 Examples: ~Color0~ : Black
  312.                       ~Color1~ : Blue
  313.                       ~Color14~ : Magenta
  314.  
  315. ~BCOLORnumber~               =- Changes Text Background Color to the selected
  316.                 number that fits its ASCII Color Number.
  317.                 Examples: ~Bcolor0~ : Black
  318.                       ~Bcolor1~ : Blue
  319.                       ~Bcolor14~ : Magenta
  320.  
  321. *note on ~BCOLOR ~ commands. If you wish to initalize the screen background
  322. to the ~BCOLOR ~ color then you should use the ~CLEAR~ command after it, else 
  323. only the screen attributes behind the current cursor location. Try it out & see.
  324.  
  325. ~CENTERnum <Text to Center>~ =- Centers a string of Text on the line number that
  326.                 is specified.  Example: ~CENTER12 <Hi>~ would
  327.                 center Hi on line number 12.
  328.  
  329. ~CENTERnum variable-letter~  =- Centers a variable-letter on the line number 
  330.                 that you specify. Example ~Center12 A~ would
  331.                 center any string that is contained in the 
  332.                 letter-variable A.  See ~GET ~ Command.
  333.  
  334. ~PAUSEnumber~                =- Pauses the program for set number of Milli-secs.
  335.                 Example: ~Pause1000~ would pause the program for
  336.                 1000 milli-seconds or 1 second.
  337.  
  338. ~OPEN filename~              =- This Command will Open or Create the filename 
  339.                 that is specified.  Example ~Open c:\Test.SCS~
  340.                 would Create the file C:\Test.SCS.  If the file
  341.                 already exist then it will be Appended.
  342.  
  343. ~APPEND <text>~              =- This Command will Append to the filename that is
  344.                 specified.  Example: ~Append <Hi>~ will Append
  345.                 or write Hi to the filename Opened with the 
  346.                 ~Open ~ Command.  Make sure you assign or Open
  347.                 before appending.
  348.  
  349. ~APPEND variable-letter~     =- This Command will Append to the Filename that is
  350.                 specified with the Open command.  An Example is:
  351.                 ~Append A~ would Append or Write the var-letter
  352.                 A to the file opened. 
  353.  
  354. ~PRINT <text>~               =- Same as the ~APPEND ~ command but sends output
  355.                 to Printer instead.
  356.  
  357. ~PRINT variable-letter~      =- Same as the ~APPEND ~ command but sends output
  358.                 to Printer instead.
  359.  
  360. # #
  361. # ^
  362. ^ ^
  363. ^ #                          =- These commands will write whatever is inbetween
  364.                 them. # HI # would write Hi to the user screen.
  365.  
  366. @                            =- Goes to the next line.
  367.  
  368. ................................................................................
  369.  
  370.  
  371.                   SimCode Modes
  372.  
  373. ................................................................................
  374.  
  375.  
  376. SimCode currently has two modes it has a Real mode and a Con mode.  The first
  377. mode that we will look at is the Con Mode.
  378.  
  379. The Con Mode is the mode in which SimCode goes into if no parameters are 
  380. passed to SimCode and the users types enter at the opening command of internal
  381. SimCode which is the Filname or Enter for Con Mode= prompt. 
  382.  
  383. There are Three ways to end the Con Mode, the Halt command, ^Z or ^C.  Any of
  384. these three commands will work, but the ~HALT~ command is the preferred. 
  385.  
  386. In Con mode, instead of SimCode looking into a file for commands, it will wait
  387. for the end user to manually type in the commands from the keyboard one line
  388. at a time.  In the Con Mode there are few commands that will not work right,
  389. see Appendix D - "CON MODE ERRORS AND PROBLEMS".
  390.  
  391. The Con mode is perfect for someone that is new to SimCode to learn how to 
  392. program in SimCode. Most all of the basic commands will work just as they 
  393. would in the Real mode.  The added advantage of the Con Mode is to check out
  394. a command to see if it will do what you want it to do.  It is also helpful 
  395. because you can load your editor and another copy of Simcode from within it
  396. with the ~RUN ~ and ~DOS~ commands. 
  397.  
  398. I suggest that you print out a copy of your SimCode.DOC and practice each 
  399. command from the Doc in the Con Mode.
  400.  
  401. ()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()
  402.  
  403.             The SimCode Real Mode.
  404.             ----------------------
  405.  
  406. In real mode, SimCode looks for a filename (Script) to run.  Scripts may be
  407. created with any Pure Ascii Editor, or the Copy Con command at Dos.  The 
  408. default Extension for a SimCode Command Script is SCS, and if you type:
  409. SIMCODE THISISIT at the command prompt in dos, SimCode will automatically add
  410. the Extension .SCS.  If for some reason you do not want the SCS extension or
  411. you dont wish to have a extension at all, that is okay, just remeber that if
  412. you do not have a extension to type a . behind the filename or the Interpeter
  413. will think that it is looking for a SCS file extension by the Filename.  
  414. Example: Say you have three programs as such: SIMTEST.SCS, SIMTEST.TST and the
  415. file SIMTEST. you would type the following to run each example:
  416.  
  417. SIMTEST.SCS    type <SIMCODE SIMTEST or SIMCODE SIMTEST.SCS> at the prompt.
  418. SIMTEST.TST    type <SIMCODE SIMTEST.TST> at the prompt.
  419. SIMTEST.       type <SIMCODE SIMTEST.> at the prompt.
  420.  
  421. In the Real mode, a Script will end in one of a few ways:
  422.   1) End of File  --- No more commands to run.
  423.   2) ~HALT~ command --- Controlled Stop.
  424.   3) RUNTIME error --- Missing Script file.
  425.  
  426.   Of the above, Number 1 is probley the best way to end a Script, since in the
  427.   Shareware version of SimCode, there is no looping, a ~HALT~ command is only
  428.   a waste of space, since there is no nesting.
  429.  
  430.   Also in reference to Number 3, it is not likely that you will get a RunTime
  431.   error, but it is still possible under the right conditions.
  432.  
  433. You may convert any Pure Ascii Text files, into Simcode Command Scripts at any
  434. time from dos by using the TXT2SCS.EXE program included with SimCode.  An good
  435. example would be if you had a DOC file to distrubite with your software, but
  436. also wanted a self pausing Script to go with it you would take that filename
  437. let's say AGAME.DOC and convert it into a Script by typing 
  438.              TXT2SCS AGAME.DOC AGAME.SCS
  439.  
  440.  
  441.  
  442. )))))))))))))))))))))))))))))))))))))))(((((((((((((((((((((((((((((((((((((((((
  443.  
  444.                      ============================
  445.                      =The SimCode Command Script= 
  446.                      ============================
  447.  
  448.  
  449.  The SimCode Command Script or (SCS) is the core of the SimCode Programming 
  450. language.  SimCode reads from Commands Scripts and converts them into actions.
  451.  
  452. For example one of the smallest possible SimCode Scripts would be:
  453.  
  454. ⁄ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø
  455. ≥~Red~                                                                        ≥
  456. ≥~Back Black~                                                                 ≥
  457. ≥~Clear~                                                                      ≥
  458. ≥# Hello                                                                      ≥
  459. ≥      Welcome to the world of SimCode.                                       ≥
  460. ≥                                      The Easiest Programming Language       ≥
  461. ≥                                                                      ever!! ≥
  462. ≥                                                                            #≥
  463. ≥~Xy29,24~                                                                    ≥
  464. ≥~More~                                                                       ≥
  465. ¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ
  466.  
  467. The Above would Change the Text Foreground Color to Red, then the background
  468. would be changed to Black, and the Screen Cleared.  After the Screen is cleared
  469. SimCode will Display the line Hello Welcome to the World... Just like it is in
  470. the above box, then the cursor would goto line 24 column 29 and wait for a key
  471. to be pressed.
  472.  
  473. To call another Script Called MYscript.SCS you would do the following comamnd.
  474.  
  475. ⁄ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø
  476. ≥~CALL Myscript.SCS 10~≥
  477. ¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ
  478.  
  479. The above would call Myscript.scs and run it then return control to the parent
  480. Script.
  481.  
  482. And Example would be the following:
  483.  
  484. ⁄ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø
  485. ≥                            Script1.scs                                      ≥
  486. ≥~Red~                     Set Foreground Color to Red.                       ≥
  487. ≥     ~Back Black~         Set Background Color to Black.                     ≥
  488. ≥                 ~Clear~  Clear the Screen.                                  ≥
  489. ≥                                                                             ≥
  490. ≥#Welcome to SimCode# @@@  Write Welcome to SimCode then space down 3 lines.  ≥
  491. ≥                                                                             ≥
  492. ≥#Calling Script2#      Write Calling Script2 to screen.                      ≥
  493. ≥@@@                    Space down Three Lines.                               ≥
  494. ≥~ENTER~                Wait for enter key to be pressed.                     ≥
  495. ≥~Call Script2.SCS 11~  Load Script2.scs with color 11.                       ≥
  496. ≥                                                                             ≥
  497. ≥~Color12~   Change Foreground Color to Light Red.                            ≥
  498. ≥~Clear~    Clear Screen.                                                     ≥
  499. ≥#bye bye#@ Write bye bye to screen.                                          ≥
  500. ≥~xy29,24~ Goto Line 24 Column 29.                                            ≥
  501. ≥~Bcolor1~ Change Back Ground Color to Blue.                                  ≥
  502. ≥~More~   Wait for user to press a key.                                       ≥
  503. ¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ
  504.  
  505. ⁄ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø
  506. ≥                           Script2.scs                                       ≥
  507. ≥                                                                             ≥
  508. ≥~Green~                     Set Color to Green.                              ≥
  509. ≥~Center12 <I am Script2>~   Center I am Script2 on line 12.                  ≥
  510. ≥~Pause2000~                 Pause for 2 seconds.                             ≥
  511. ¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ
  512.  
  513. The above describes what it is doing inside the Script.  Anything out side of
  514. the ~ # ^ or @ commands is comments.
  515.  
  516. An Example of the ~GET ~, ~USE ~, ~PRINT ~ and ~APPEND ~ commands:
  517.  
  518. ⁄ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø
  519. ≥#What is your Name # ~GET A~  Prompt for user name, then store to A.         ≥
  520. ≥@                                                                            ≥
  521. ≥#What is your Age # ~GET B~  Prompt for user age, then store to B.           ≥
  522. ≥@                                                                            ≥
  523. ≥#What is your City # ~GET Z~ Prompt for user city, then store to Z.          ≥
  524. ≥@                                                                            ≥
  525. ≥@                                                                            ≥
  526. ≥~GREEN~                                                                      ≥
  527. ≥#Your name is # ~USE A~  Display your name is and return A.                  ≥
  528. ≥@                                                                            ≥
  529. ≥#Your age is # ~USE B~  Display your age is and return B.                    ≥
  530. ≥@                                                                            ≥
  531. ≥#Your City is # ~USE Z~ Display your city is and return Z.                   ≥
  532. ≥@                                                                            ≥
  533. ≥@                                                                            ≥
  534. ≥@                                                                            ≥
  535. ≥~OPEN DATABASE.DAT~                                                          ≥
  536. ≥~APPEND A~                                                                   ≥
  537. ≥~APPEND B~                                                                   ≥
  538. ≥~APPEND Z~                                                                   ≥
  539. ≥~PRINT A~ ~PRINT B~ ~PRINT Z~                                                ≥
  540. ¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ
  541.  
  542. The above program is an example of the Variable, File and Printer Commands.
  543.  
  544. The Program will prompt the user for his name, age, and city, store the user's
  545. input into A,B,and Z.  Then will Re-Display the Users Answers, and then it will
  546. Open up DATABASE.DAT and APPEND A,B,and Z answers to DATABASE.DAT.  If DATABASE
  547. file does not exist it will create it, else it will just append to the end of
  548. the file.  The Last line will print the answers to the Printer.
  549.  
  550. At the time of this document, using the ~PRINT ~ command without a printer 
  551. online would result in a runtime error.  Hopefully this problem was fixed. You
  552. may wish to look into the Last.Add file to see if there is any updates on the
  553. ~PRINT ~ command.
  554.  
  555. Examples of the ~SOUND ~, ~STAR~, ~PAUSE ~, ~TIME~, ~DATE~, and ~DOS~ commands:
  556.  
  557. ⁄ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø
  558. ≥~SOUND500,1000~ Sound 500mhz for 1 second.                                   ≥
  559. ≥~Pause 2000~ Pause for 2 seconds.                                            ≥
  560. ≥~TIME~ @ Display current Time.                                               ≥
  561. ≥~DATE~ @ Display Currnet date.                                               ≥
  562. ≥~Star~ Plays theme song for a certain movie.                                 ≥
  563. ≥~DOS~ Shell to dos until user types EXIT.                                    ≥
  564. ≥~ENTER~                                                                      ≥
  565. ¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ
  566.  
  567. The Below is an Example of the Ascii to Screen Command.
  568.  
  569. ⁄ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø
  570. ≥~Ascii1~ Display ascii character 1 # This is a example of the Ascii Command #≥
  571. ≥~Ascii2~ Display ascii character 2                                           ≥
  572. ¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ
  573.  
  574. [[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]
  575.  
  576.  
  577.                      But what can I use SimCode for?
  578.              -------------------------------
  579.  
  580.  Well first off as I stated earlier, you can Use SimCode BBS Doors, but a more
  581. broad use for SimCode could be either teaching, fun, or SimCode could also be
  582. used as a Installation program, or a Program introduction.  For an example, I
  583. have a game called No-Nuke that is released as shareware, I used SimCode as a
  584. Introduction Document Script to No-Nuke.  I also have used it for this program
  585. too.  Bye running Install.Bat you was also running SimCode.SCS.  The use of 
  586. SimCode is up to you.
  587.  
  588. ]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]][[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[
  589.  
  590.  
  591.                      License Agreement for Private Use.
  592.                      ----------------------------------
  593.  Hey as long as it is not public I dont care what you use SimCode for, but if 
  594. SimCode is released with a script, you must register SimCode for $5.00.
  595.  
  596.  
  597. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  598.  
  599.  
  600.  
  601.         For Additional Script help, please call me at (502)856-3788.
  602.  
  603.  
  604. ===============================================================================
  605.  
  606.  
  607. Other Programs by the Author of SimCode:
  608.  
  609.   No-Nuke - Action game, can you save three cities before the warheads strike?
  610.             EGA/VGA mouse driven game.
  611.  
  612.   Cryptic Thoughts - Nice little File Encoder/Decoder.
  613.  
  614.   Madlibs - Cool word game with a twist.
  615.  
  616.   AutoMess - Automatic Messager for Searchlight BBS.
  617.  
  618.   Slusage - Usage Chart for Searchlight BBS.
  619.  
  620. -------------------------------------------------------------------------------
  621.  
  622. Last Minute Updates.
  623.  
  624. Added Command - ~MAGENTA~ Changes Text Foreground Color to Magenta
  625.  
  626. Added Command - ~SET letter-variable=string~ 
  627.   
  628. Added Command - ~If letter-Variable=<string> script~
  629.  
  630. Added Command - ~If Not letter-Variable=<string> script~
  631.  
  632. Added Command - ~Do script times~
  633.  
  634. Added utility - UnLinker
  635.  
  636. Changed Feature - Does not Force UpCase Conversion upon Runtime
  637.  
  638. --------------------------------------------------------------------------------
  639.  
  640.                        Using Added Commands
  641.  
  642.  
  643. The Set Command allows a programmer to preset the seleceted letter-variables. An
  644. Example on using the Set command would be if you was writing a program and used
  645. the string "Cool I like that" alot you could just assign "Cool I like that" to a
  646. letter-variable and use the use command to retrieve it.  To do that you would 
  647. just use the Set command as follows: ~Set A=Cool I like that~.
  648.  
  649. ===
  650.  
  651. The If and If Not Commands allow for a programmer to include decision making 
  652. commands.  Say you wanted to right a program to do a certain thing if the users
  653. name was Ted, but a total opposite thing if it was not. If the users name is Ted
  654. we will call the Script HiTed.scs and if the users name is not Ted we will call
  655. NotTed.Scs.  Example usage: 
  656.                            #What is your Name #
  657.                            ~Get A~
  658.                            ~If A=<Ted> Ted.Scs~
  659.                            ~If Not A=<Ted> NotTed.Scs~
  660.  
  661. Warning, the If command is currently Case Sensitive so make sure that you watch
  662. for variations in the matching process.  If you say try watching for Ted but the
  663. user inputs TED, simcode will not know that Ted is the same as TED.  
  664.  
  665. ===
  666.  
  667. The Do Command is a simple looper command.  Example:  You want to draw a line of
  668. smiley faces (Ascii1) across the screen, the simplest way would to be to use the
  669. do command as follows:
  670.                       ~Do Ascii1.scs 80~
  671.                 and in Ascii1.scs you would have
  672.                       ~Ascii1~
  673. The Syntax for the Do Command is Do scriptname number-of-times.
  674.  
  675. ===
  676.  
  677. An new added Utility is the SimCode Linked Scripts Conversion utility.  Now by
  678. using the SLS utility you can create all your SCS files in a single file then
  679. type SLS2SCS and create all your scripts from one script.  
  680.  
  681. All you have to do is for each script block specify a scriptname by using the %
  682. command, and ending block area with the | command.  
  683.  
  684. Example:
  685.  
  686. %Script1.scs%
  687. ~RED~
  688. ~CENTER12 <This is Script1>~
  689. ~MORE~
  690. ~CALL Script2.scs 10~
  691. |
  692. %Script2.scs%
  693. ~Blue~
  694. ~Center12 <This is Script2>~
  695. ~MORE~
  696. |
  697.  
  698. The Above will be saved into the filename LINKED.SLS then will be converted into
  699. the scripts SCRIPT1.SCS and SCRIPT2.SCS when Converted using SLS2SCS.
  700.  
  701. -----
  702.  
  703.  Other Bugs Fixed:
  704.  
  705.   Though not really a bug, older versions of SimCode compiled one line of a SCS
  706. at a time, then executed that line before moving on to the next.  This slowed
  707. the program down a little do to constant disk write/reading.  Beta Tester Garrie
  708. Wilson suggested all compilation at one time, which speeds up the process but
  709. requires about 5k more ram to use do to the large number of arrays.   Though
  710. left out of this version, the 7.0 will allow a switch for the programmer to
  711. choose what type of compiling he/she wants.
  712.